Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-021 |
| Deskripsi | Laporan retur penjualan per customer: daftar retur dalam periode, barang yang diretur, kuantitas order dan retur, serta nominal retur |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka Laporan Retur Penjualan dari daftar Laporan Penjualan.
- User mengisi periode, mode penjualan, dan memilih customer.
- User melihat retur per customer: nomor invoice retur, invoice penjualan asal, nama barang dan varian, total order, kuantitas retur, dan total nominal retur.
- User membuka invoice retur atau invoice penjualan asal di tab baru.
- User mengekspor laporan ke Excel jika memiliki hak akses.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan retur penjualan dalam periode, dikelompokkan per customer |
| FR-02 | User dapat memfilter customer dan mode penjualan |
| FR-03 | User dapat membuka invoice retur dan invoice penjualan asal |
| FR-04 | User dengan izin Excel dapat mengekspor laporan retur penjualan |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Melihat retur penjualan per customer dalam periode |
| UC-02 | Membuka invoice retur atau invoice penjualan asal |
| UC-03 | Mengekspor laporan retur penjualan ke Excel |
4. Use Case Scenario
UC-01 : Melihat retur penjualan per customer dalam periode
| Aktor | User penjualan / akuntansi |
| Deskripsi | User melihat seluruh retur penjualan dan barang yang diretur |
| Prekondisi | User memiliki izin #lap-retur-penjualan |
| Alur utama | 1. User membuka Laporan Penjualan lalu Laporan Retur Penjualan. 2. User mengisi periode dan mode penjualan. 3. User dapat memilih satu atau beberapa customer. 4. User menekan tombol tampilkan. 5. Sistem menampilkan retur per customer beserta barang, total order, kuantitas retur, dan total nominal retur. |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika mode penjualan kosong, muncul alert "Mode Penjualan harus diisi!". - Jika data kosong atau gagal dimuat, muncul notifikasi "Data yang anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Periode memakai tanggal invoice retur dan diurutkan dari tanggal terlama. - Data retur diambil per baris barang retur beserta invoice penjualan asalnya. - Nama customer dan nama barang dilengkapi dari master. |
| Postkondisi | Laporan retur penjualan tampil |
| Trigger | User menekan tombol tampilkan |
| Kode FR | FR-01 FR-02 |
UC-02 : Membuka invoice retur atau invoice penjualan asal
| Aktor | User penjualan / akuntansi |
| Deskripsi | User menelusuri dokumen retur atau penjualan asal |
| Prekondisi | Laporan sudah tampil |
| Alur utama | 1. User mengklik nomor invoice retur atau nomor invoice penjualan. 2. Sistem membuka halaman lihat dokumen tersebut di tab baru. |
| Alur negatif | - Jika dokumen sudah dihapus, halaman lihat menampilkan pesan dokumen tidak ditemukan. |
| Bisnis rule | - Nomor retur membuka halaman lihat retur penjualan, nomor penjualan membuka halaman lihat penjualan. |
| Postkondisi | Dokumen terbuka di tab baru |
| Trigger | User mengklik nomor invoice |
| Kode FR | FR-03 |
UC-03 : Mengekspor laporan retur penjualan ke Excel
| Aktor | User dengan izin Excel retur penjualan |
| Deskripsi | User mengunduh laporan retur penjualan |
| Prekondisi | Laporan sudah tampil |
| Alur utama | 1. User menekan tombol export Excel. 2. Sistem menyusun baris dari data tabel. 3. Browser mengunduh "Daftar Retur Penjualan per Customer.xlsx". |
| Alur negatif | - Jika filter belum diterapkan, muncul notifikasi "Periode Tidak Boleh Kosong". - Jika data kosong, muncul notifikasi "Data tidak ditemukan". |
| Bisnis rule | - Tombol tampil bila user memiliki izin excel pada #lap-retur-penjualan. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan tombol export Excel |
| Kode FR | FR-04 |
5. Data Flow Diagram
DFD-01 — Alur data retur penjualan
6. Sequence Diagram
SD-01 — UC-01 : Melihat retur penjualan per customer dalam periode
SD-02 — UC-02 : Membuka invoice retur atau invoice penjualan asal
SD-03 — UC-03 : Mengekspor laporan retur penjualan ke Excel
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
POST /laporan-penjualan/invoice-return-penjualan-report | existing | - |
GET /customer | existing | - |
POST /sku/get-bulk-sku | existing | - |